winsafe\mf\com_interfaces/
imfmediasource.rs

1#![allow(non_camel_case_types, non_snake_case)]
2
3use crate::co;
4use crate::decl::*;
5use crate::kernel::privs::*;
6use crate::mf::vts::*;
7use crate::ole::privs::*;
8use crate::prelude::*;
9
10com_interface! { IMFMediaSource: "279a808d-aec7-40c8-9c6b-a6b492c78a66";
11	/// [`IMFMediaSource`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nn-mfidl-imfmediasource)
12	/// COM interface.
13	///
14	/// Automatically calls
15	/// [`Release`](https://learn.microsoft.com/en-us/windows/win32/api/unknwn/nf-unknwn-iunknown-release)
16	/// when the object goes out of scope.
17}
18
19impl mf_IMFMediaEventGenerator for IMFMediaSource {}
20impl mf_IMFMediaSource for IMFMediaSource {}
21
22/// This trait is enabled with the `mf` feature, and provides methods for
23/// [`IMFMediaSource`](crate::IMFMediaSource).
24///
25/// Prefer importing this trait through the prelude:
26///
27/// ```no_run
28/// use winsafe::prelude::*;
29/// ```
30pub trait mf_IMFMediaSource: mf_IMFMediaEventGenerator {
31	/// [`IMFMediaSource::GetCharacteristics`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-getcharacteristics)
32	/// method.
33	#[must_use]
34	fn GetCharacteristics(&self) -> HrResult<co::MFMEDIASOURCE> {
35		let mut characteristics = co::MFMEDIASOURCE::default();
36		ok_to_hrresult(unsafe {
37			(vt::<IMFMediaSourceVT>(self).GetCharacteristics)(self.ptr(), characteristics.as_mut())
38		})
39		.map(|_| characteristics)
40	}
41
42	fn_com_interface_get! { CreatePresentationDescriptor: IMFMediaSourceVT => IMFPresentationDescriptor;
43		/// [`IMFMediaSource::CreatePresentationDescriptor`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-createpresentationdescriptor)
44		/// method.
45	}
46
47	fn_com_noparm! { Pause: IMFMediaSourceVT;
48		/// [`IMFMediaSource::Pause`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-pause)
49		/// method.
50	}
51
52	fn_com_noparm! { Shutdown: IMFMediaSourceVT;
53		/// [`IMFMediaSource::Shutdown`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-shutdown)
54		/// method.
55	}
56
57	/// [`IMFMediaSource::Start`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-start)
58	/// method.
59	fn Start(
60		&self,
61		presentation_descriptor: IMFPresentationDescriptor,
62		time_format: Option<&GUID>,
63		start_position: &PropVariant,
64	) -> HrResult<()> {
65		ok_to_hrresult(unsafe {
66			(vt::<IMFMediaSourceVT>(self).Start)(
67				self.ptr(),
68				presentation_descriptor.ptr(),
69				pcvoid(time_format.unwrap_or(&GUID::default())),
70				pcvoid(&start_position.to_raw()?),
71			)
72		})
73	}
74
75	fn_com_noparm! { Stop: IMFMediaSourceVT;
76		/// [`IMFMediaSource::Stop`](https://learn.microsoft.com/en-us/windows/win32/api/mfidl/nf-mfidl-imfmediasource-stop)
77		/// method.
78	}
79}